                              //
ЩЭЭЭЭЭЭЛЩЭЛ  ЩЭЛЩЭЭЭЭЭЭЛЩЭЭЭЭ//ПкФФФФФФПкФФПкФФП
К   ЩЭЭМК КЩЛК КК      КК   // ГГ      ГГ  ГГ  Г
К   ШЭЭЛК ШМШМ КШЭЛ  ЩЭМК  //  ГГ  кФФФйГ  Рй  Г
ШЭЛ    КК  ЩЛ  К  К  К  ШЭ// кФйГ  РФФФПГ  кП  Г
ЩЭМ    КК  КК  КЩЭМ  ШЭЛ //  Г  Г      ГГ  ГГ  Г
К      КК  КК  КК      К//Г  Г  Г      ГГ  ГГ  Г
ШЭЭЭЭЭЭМШЭЭМШЭЭМШЭЭЭЭЭЭ// РФФй  РФФФФФФйРФФйРФФй
                      //

                                 Version 2.1a
                       (c) 1991-1995 by Craig A. Cassidy



 A DOS command line utility that allows you to perform a word-processor-like
 search and replace on text strings in standard ASCII text files.


   кТТТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТТТП
   РСССССФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСССССй



SWITCH is a small utility designed to replace occurrences of strings in ASCII
text files.  The usefulness of this utility comes from its ability to
perform numerous changes without user intervention thus allowing you to
quickly make global changes to a file or to run the program from within a
batch file.



ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФП
Г I. Syntax УФП
РФТФФФФФФФФФй Г
  РФФФФФФФФФФФй

     кФ Command Line Syntax (Input File Format): ФФФФФФФФФФФФФФФФФФФФФФФФФФФП
     Г                                                                      Г
     Г SWITCH targetfile /f:input-file                                      Г
     РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

     кФ Command Line Syntax (No Input File): ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
     Г                                                                      Г
     Г SWITCH targetfile search-string replace-string [optional parameters] Г
     РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
                               - figure 1 -


   There are several possible command line options you may use with the
   SWITCH program.  The format of the command line will vary greatly
   depending on the source of input for the "switch."  In all cases the
   first required parameter will be the name of the file that you wish to 
   change (referred to as "targetfile" in figure 1).

   If you wish to switch only one set of strings in your target file, you may
   specify them on the command line as the second and third required
   parameters.  These two parameters are referred to as "search-string" and
   "replace-string" in the figure above.  Optionally you could specify a
   source-file-name using the /f: option (ex: /f:myfile.txt).  Doing this
   overrides the need to specify any options other than the targetfile.

   The "TargetFile" option may contain wildcards (i.e. "*" and "?").  These
   wildcards are used in the same manner they would be for a DOS command
   such as "DEL".  When using wildcards SWITCH will process all files meeting
   the criteria specified.  "targetfile" may also contain a fully specified
   path name (i.e. "C:\WORD\DOCS\MYFILE.TXT").

   Both the "Search-String" and "Target-String" parameters may contain
   multiple word phrases (i.e. "Mary had a little lamb.") so long as they
   are surrounded by quotes.



ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФФФФФФФФФФФФФФФП
Г II. Optional Parameters УФП
РФТФФФФФФФФФФФФФФФФФФФФФФФй Г
  РФФФФФФФФФФФФФФФФФФФФФФФФФй

    In order to customize the way SWITCH will do a search-and-replace, you
    must specify certain optional parameters either on the command line or
    in the input file.  These parameters must be preceded by a "/" if used
    on the command line.

    Following is a description of each option:

     ЩЭЭЭЭЭЭбЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЛ
     К Code Г Description                                                  К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  c   Г Case-Sensitivity Off                                         К
     К      Г                                                              К
     К      Г Turns case-sensitivity OFF when searching for a string.      К
     К      Г When searching for "hello" in a text and SWITCH finds the    К
     К      Г words "Hello" or "HELLO" they will be recognized and         К
     К      Г switched if the "c" parameter is specified.  SWITCH by       К
     К      Г default will assume the search will be case sensitive.       К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  v   Г View Altered Lines                                           К
     К      Г                                                              К
     К      Г This option will display each altered line on the screen as  К
     К      Г it is switched for the user to monitor.  If the number of    К
     К      Г changes exceeds the number of lines visible on the screen    К
     К      Г then SWITCH will pause until the user has pressed a key.     К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  p   Г Prompt For File Names                                        К
     К      Г                                                              К
     К      Г When a number of files have been specified as targets for a  К
     К      Г "switch" the user may wish to be prompted for confirmation   К
     К      Г before each one is altered.  The "p" option does just that.  К
     К      Г As each file meeting the specified criteria is encountered,  К
     К      Г SWITCH will request a (y/n) confirmation from the user.      К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  w   Г Whole Words Only                                             К
     К      Г                                                              К
     К      Г In some situations you may need to switch a word that could  К
     К      Г be a subset of a larger word.  To illustrate, suppose you    К
     К      Г want to change all occurrences of the word "car" to          К
     К      Г "automobile" in a text.  Without the "w" option the word     К
     К      Г "card" would be accidentally switched to "automobiled."      К
     К      Г By default SWITCH will NOT assume that you are switching     К
     К      Г whole words only.                                            К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  s   Г Search Subdirectories                                      * К
     К      Г                                                              К
     К      Г SWITCH is capable of searching and replacing strings in      К
     К      Г multiple files at once using wildcards in the target-file    К
     К      Г parameter.  In addition to this feature, SWITCH provides a   К
     К      Г means of searching for files outside of the specified (or    К
     К      Г default) path.  The "s" option will allow the program to     К
     К      Г search for files in or BENEATH the specified path on the DOS К
     К      Г directory tree.                                              К
     К      Г                                                              К
     К      Г         C:\ФФТФФDOS                                          К
     К      Г              УФФDATAФФФФТTEXT                                К
     К      Г              РФФUTILS   РDOCS                                К
     К      Г                                                              К
     К      Г In the above directory tree if the following switch command  К
     К      Г were to be executed: "SWITCH C:\DATA\*.TXT hi hello /s"      К
     К      Г then all files ending in a ".TXT" in the "\DATA",            К
     К      Г "\DATA\TEXT" and "\DATA\DOCS" directories would be switched. К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  f   Г Specify Input File                                         * К
     К      Г                                                              К
     К      Г The "f" option allows for the switching of numerous search   К
     К      Г and replace strings within the specified file(s) by using    К
     К      Г an input file containing a list of all of the search and     К
     К      Г replace strings SWITCH will use.  The syntax for this        К
     К      Г parameter is "/f:filename" where filename is the name of the К
     К      Г input file.                                                  К
     К      Г                                                              К
     К      Г Example:  SWITCH *.txt /f:myfile                             К
     К      Г                                                              К
     К      Г In this example all ".TXT" files are switched using the      К
     К      Г criteria found in the file called "MYFILE.TXT."  See the     К
     К      Г section titled "Input File Format" for details on creating   К
     К      Г an input file.                                               К
     ЧФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФЖ
     К  r   Г Simply displays the registration information for the SWITCH  К
     К      Г program.  Please register this product.                    * К
     ШЭЭЭЭЭЭЯЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭМ
                           - Table One: Options -

     * Denotes options not available WITHIN an input file.



ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФФФФФФФФФФФФФФП
Г III. Input File Format УФП
РФТФФФФФФФФФФФФФФФФФФФФФФй Г
  РФФФФФФФФФФФФФФФФФФФФФФФФй

    When using an input file to perform multiple switches the following
    conventions must be followed for each line:

          search-string,replace-string,options

    One line for each search and replace string pair must be created.  The
    strings must be separated by a comma and any options to be used in the
    switch must be placed on the same line separated again by a comma. An
    example of an input file might look like this:

            кФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
            Г hello,Hello,cw                                      Г
            Г switch,SWITCH,c                                     Г
            Г Old,New,cv                                          Г
            Г Garbage Man,Waste Disposal Technician,cv            Г
            Г Stewardess,Flight Attendant,cv                      Г
            Г                                                     Г
            ГкПкПкП                                         кП  кПГ
            РйРйРйРП                  кП                   кйГкПГРй
                   РП    кП       кПкПГГкПкФПкП    кПкФПкПкй РйРй
                    РПкПкйРПкПкПкФйРйРйРйРй РйРПкПкйРй РйРй
                     РйРй  РйРйРй              РйРй
                            - Example One -


    In Example One the five search-strings are replaced by their
    corresponding replace strings using the options particular to each pair.
    Note that phrases containing more than one word ARE valid.  Unlike the
    command-line, multiple word phrases do not need to be surrounded by
    quotes.

    This file may be created with any editor capable of saving to an ASCII
    text file.


ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФФФФП
Г IV. Examples УФП
РФТФФФФФФФФФФФФй Г
  РФФФФФФФФФФФФФФй

    The following examples demonstrate just a few ways you might use the
    SWITCH utility.  The first example is a simple application where a field
    in the target file needs to be changed to a user's initials from a
    generic label called simply "initials":


      кД No Input File Example УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
      Г                                                                      Г
      Г C:\>SWITCH datafile.txt Initials CAC /c /v /w                        Г
      Г                                                                      Г
      Г РТФйРФТФФй РФФФФТФФФФФй РФФТФФФй РТй РФФТФФФй                        Г
      Г  Г    Г         Г          Г      Г     РФ Optional Parameters       Г
      Г  Г    Г         Г          Г      РФ Target string (what the search  Г
      Г  Г    Г         Г          Г         string will be switched to)     Г
      Г  Г    Г         Г          РФ Search string                          Г
      Г  Г    Г         РФ Name of the target file to be switched            Г
      Г  Г    РФ Executes the SWITCH Program                                 Г
      Г  РФ DOS Command Prompt                                               Г
      Г                                                                      Г
      РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
                            - Example Two -

    This example will switch all occurrences of the string "initials" to "CAC"
    in the file "DATAFILE.TXT."  It will not care if "initials" is capitalized
    in any spot (via the "/c") and it will not switch any word that CONTAINS
    the word "initials" (via the "/w") such as "myinitials."  SWITCH will also
    display each altered line on the screen for the user to view (via the
    "/v" option).

    The next example demonstrates an entirely different way of using SWITCH. 
    In the following example the "/f:" option is used specifying that all
    search and replace pairs will be input from a text file rather than from
    the command-line.

      кД Input File Example УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
      Г                                                                      Г
      Г C:\>SWITCH \data\*.txt /f:sw-file.txt /s /p                          Г
      Г                                                                      Г
      Г РТФйРФТФФй РФФФФТФФФФй РФФФФФТФФФФФФй РФТФй                          Г
      Г  Г    Г         Г            Г          РФ Optional Parameters       Г
      Г  Г    Г         Г            РФ Name of input file containing a list Г
      Г  Г    Г         Г               of search and replace strings        Г
      Г  Г    Г         РФ File specification (files to be switched)         Г
      Г  Г    РФ Executes the SWITCH Program                                 Г
      Г  РФ DOS Command Prompt                                               Г
      Г                                                                      Г
      РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
                           - Example Three -

    The above example also makes use of the powerful "/s" option which, in 
    this instance will allow SWITCH to perform on all ".TXT" files in the
    "\DATA" directory and ALL directories that fall beneath it on the
    directory tree.

    The "/p" option in this case will cause SWITCH to pause before each file
    matching the specified description to ask the user if the file should be 
    altered similar as in the following example:

           SWITCH thisfile.txt? (y/n): _

    The computer will halt processing until the user presses either the "y"
    or the "n" key therefore this option is not recommended for batch file
    applications.


ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФФФФФП
Г V. Disclaimer УФП
РФТФФФФФФФФФФФФФй Г
  РФФФФФФФФФФФФФФФй

    SWITCH has been tested extensively and has not exhibited any problems
    causing loss of data integrity or otherwise.  This does not mean that
    this product (or any other) is infallible.  You should always keep
    backup copies of any data that is valuable to you.

    Use this software at your own risk.  We can not be responsible for any
    damages due to loss of data, data corruption or other means.


ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
кФФФФФФФФФФФФФФФФФФП
Г VI. Registration УФП
РФТФФФФФФФФФФФФФФФФй Г
  РФФФФФФФФФФФФФФФФФФй

    Should you find this software to be useful you are urged to register it.
    Once you have done this you will receive a registration number and proof
    of purchase as well as any future updates to the software as they become
    available.  Register by sending $25 to:

         Craig Cassidy
         58 S. Forge Manor Dr.
         Phoenixville, PA  19460
         
         CompuServe: 72124,1723

    Comments and suggestions are also welcome.


             лллллллП ллП  ллП лллллллП ллллллП ллллллП ллП ллП
             ллкФФФФй ллГ  ллГ РФллкФФй РФллкФй ллкФФФй ллГ ллГ
             лллллллП ллГлПллГ   ллГ      ллГ   ллГ     ллллллГ
             РФФФФллГ лллллллГ   ллГ      ллГ   ллГ     ллкФллГ
             лллллллГ лллклллГ лллллллП   ллГ   ллллллП ллГ ллГ
             РФФФФФФй РФФйРФФй РФФФФФФй   РФй   РФФФФФй РФй РФй
                   V2.1a (c) 1991-1995 by Craig A. Cassidy